Skip to content

frontier-readiness: gap #5 audit — ALIGNMENT.md (factory-generic)#185

Merged
AceHack merged 4 commits intomainfrom
frontier-readiness/audit-alignment-md
Apr 24, 2026
Merged

frontier-readiness: gap #5 audit — ALIGNMENT.md (factory-generic)#185
AceHack merged 4 commits intomainfrom
frontier-readiness/audit-alignment-md

Conversation

@AceHack
Copy link
Copy Markdown
Member

@AceHack AceHack commented Apr 23, 2026

Summary

Surgical refactor notes

  1. Substitute Zeta<Project> in preamble + research-claim + DIR-1
  2. Template-ify Signatures (adopter-fills-in)
  3. Keep Aaron verbatim quotes in Zeta's alignment contract as attribution anchors; Frontier references "adopter's direct verbatim statements" as pattern

Effort: S.

Running classification tally (6 audits)

File Class
CLAUDE.md both
AGENTS.md both
GOVERNANCE.md (#181) factory-generic
CONFLICT-RESOLUTION.md both
AGENT-BEST-PRACTICES.md (#184) factory-generic
ALIGNMENT.md (this) factory-generic

Attribution

Otto (loop-agent PM hat); continuing gap #5 cadence.

🤖 Generated with Claude Code

Copilot AI review requested due to automatic review settings April 23, 2026 19:41
@AceHack AceHack enabled auto-merge (squash) April 23, 2026 19:41
AceHack added a commit that referenced this pull request Apr 23, 2026
…183 merged

Sixth audit. ALIGNMENT.md classified factory-generic. 20
clauses (HC/SD/DIR) structurally instructional; substance
transfers to any adopter. Effort: S (project-name
substitution + signatures template-ify).

Load-bearing finding: the factory's alignment substrate
transfers cleanly to any Frontier adopter. Common Sense
2.0's 5 safety properties are structurally available to
any adopter inheriting Frontier, not just Zeta.

PR #183 (CONFLICT-RESOLUTION audit) merged this tick.
PR #185 (ALIGNMENT audit) armed for auto-merge.

Progress: 6 audits in 8 ticks; ~10 remaining; projected
completion ~Otto-24.

Attribution: Otto (loop-agent PM hat).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: d18144df42

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/frontier-readiness/factory-vs-zeta-separation-audit.md Outdated
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the Frontier readiness “factory vs Zeta separation” audit log to record the classification of docs/ALIGNMENT.md as factory-generic and to keep the audit progress list in sync with completed audits.

Changes:

  • Fixes/normalizes the “Files audited” list formatting and updates it to include docs/ALIGNMENT.md.
  • Removes docs/ALIGNMENT.md / docs/AGENT-BEST-PRACTICES.md from the “Files to audit” list and adds a consolidated note pointing to the PRs where related audits landed.
  • Adds a full “Audit — docs/ALIGNMENT.md” section including classification, breakdown, and refactor notes.

Comment thread docs/frontier-readiness/factory-vs-zeta-separation-audit.md Outdated
AceHack added a commit that referenced this pull request Apr 23, 2026
…-DO); halfway mark

Seventh + eighth audits landed in a single tick. Batched
cadence proven: 2× audit throughput at similar tick
overhead as single-file ticks.

AUTONOMOUS-LOOP.md: factory-generic (cleanest; zero
refactor). Otto's own operating spec inherits verbatim —
any Claude-Code-using adopter gets the autonomous-loop
discipline free.

WONT-DO.md: both (coupled). Shape transfers; Zeta-specific
entries stay in Zeta's library decision record.

Progress: 8 of ~16 files = halfway. Balanced tally 4
factory-generic + 4 both-coupled.

PR #186 armed. Seven PRs now simultaneously armed (#165/
#178/#181/#182/#184/#185/#186) — free-tier CI throughput
is the bottleneck.

Attribution: Otto (loop-agent PM hat).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@AceHack AceHack force-pushed the frontier-readiness/audit-alignment-md branch from d18144d to 4af28b5 Compare April 24, 2026 14:38
@chatgpt-codex-connector
Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

@AceHack AceHack force-pushed the frontier-readiness/audit-alignment-md branch from 4af28b5 to 3a1ea0b Compare April 24, 2026 14:45
Copilot AI review requested due to automatic review settings April 24, 2026 14:45
@chatgpt-codex-connector
Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 2 comments.

Comment thread docs/frontier-readiness/factory-vs-zeta-separation-audit.md Outdated
Comment thread docs/frontier-readiness/factory-vs-zeta-separation-audit.md Outdated
AceHack and others added 2 commits April 24, 2026 11:30
Sixth file audited. ALIGNMENT.md classified factory-
generic. Confirms the rule-substrate-instructional
hypothesis.

20 clauses (HC-1..HC-7, SD-1..SD-8, DIR-1..DIR-5) all
structurally instructional. Substance transfers to any
adopter; only project name + signatures + verbatim-quote
attributions are adopter-specific.

Refactor notes:
1. Substitute "Zeta" → <Project> in preamble + research-
   claim section + DIR-1 heading
2. Template-ify Signatures section (adopter fills in)
3. Keep Aaron verbatim quotes in Zeta repo's alignment
   contract as attribution anchors; Frontier template
   references "adopter's direct verbatim statements"
   as the pattern

Effort: S (simple project-name substitution + signatures
template-ify).

Six audits now complete. Pattern stable: instructional
→ factory-generic; state-logging / illustrative →
embedded Zeta-specifics.

Attribution: Otto (loop-agent PM hat).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
…reads

Two Copilot P1 threads on PR #185 flagged stale metadata in the
ALIGNMENT.md audit section:

- Length: ~750 lines -> 840 lines (current wc -l: 839)
- Clause total: 20 -> 21 (7 HC + 9 SD + 5 DIR)
- Soft-defaults range: SD-1..SD-8 -> SD-1..SD-9
  (SD-9 "Agreement is signal, not proof" is present in ALIGNMENT.md)

Updated the Length line and the "SD-1..SD-9 Soft defaults" row in
the section-by-section breakdown to match the current file. The
breakdown row's parenthetical now names the SD-9 clause substance
(agreement-is-signal-not-proof) alongside the existing SD-1..SD-8
entries.

No change to classification, refactor notes, or split logic.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@AceHack AceHack force-pushed the frontier-readiness/audit-alignment-md branch from 3a1ea0b to 279bd34 Compare April 24, 2026 15:30
Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 279bd347ea

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/frontier-readiness/factory-vs-zeta-separation-audit.md Outdated
Reflow line 630-631 of factory-vs-zeta-separation-audit.md
so a leading `+` inside prose no longer triggers
MD032/blanks-around-lists (markdownlint was parsing the
prose `+` at column 0 as a list marker). Move the `+` to
the end of the previous line; no content-semantic change.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings April 24, 2026 19:45
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 3 comments.

Comment thread docs/frontier-readiness/factory-vs-zeta-separation-audit.md Outdated
Comment thread docs/frontier-readiness/factory-vs-zeta-separation-audit.md Outdated
Comment thread docs/frontier-readiness/factory-vs-zeta-separation-audit.md Outdated
- Overall classification: "mixed" -> "both (coupled)" (codex P2 + copilot P1)
- DIR-1 row: heading matches source ("Zeta"), placeholder note moves to Notes column (copilot P1)
- Classification rationale: "20 clauses" -> "21 clauses", "mixed" -> "both (coupled)" (copilot P1)

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
AceHack added a commit that referenced this pull request Apr 24, 2026
- Thread P0 line 561 (markdownlint continuation-starting-with-+):
  reworded both occurrences (lines 561 and 684) so wrapped
  continuation lines no longer begin with `+` — replaced with
  `plus` / `and` / comma-series per Copilot reviewer's suggestion.

- Thread P2 line 678 (unaudited docs in pattern-summary): added
  explanatory note under the summary table clarifying that three
  audits (ALIGNMENT / TECH-RADAR / FACTORY-HYGIENE) land in
  sibling PRs #185/#188 rather than this file, and flagged that
  the rollup assumes those PRs merge. Deeper mechanical-verification
  restructure backlogged as P2 "Separation-audit cross-PR rollup".

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@AceHack AceHack merged commit eb519bc into main Apr 24, 2026
10 checks passed
@AceHack AceHack deleted the frontier-readiness/audit-alignment-md branch April 24, 2026 19:53
Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: fc5e006da9

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".


| Section | Class | Notes |
|---|---|---|
| Preamble | factory-generic | Alignment contract between human maintainer + agents. |
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Mark ALIGNMENT preamble as coupled

The section table marks the ALIGNMENT preamble as factory-generic, but this same audit later requires a pre-split Zeta<Project> substitution in the preamble. Because this document says split execution is mechanical by class, this mismatch can cause the preamble edit to be skipped and leak adopter-specific wording into the Frontier template; the preamble row should be classified consistently with the required refactor path.

Useful? React with 👍 / 👎.

AceHack added a commit that referenced this pull request Apr 24, 2026
- Thread P0 line 561 (markdownlint continuation-starting-with-+):
  reworded both occurrences (lines 561 and 684) so wrapped
  continuation lines no longer begin with `+` — replaced with
  `plus` / `and` / comma-series per Copilot reviewer's suggestion.

- Thread P2 line 678 (unaudited docs in pattern-summary): added
  explanatory note under the summary table clarifying that three
  audits (ALIGNMENT / TECH-RADAR / FACTORY-HYGIENE) land in
  sibling PRs #185/#188 rather than this file, and flagged that
  the rollup assumes those PRs merge. Deeper mechanical-verification
  restructure backlogged as P2 "Separation-audit cross-PR rollup".

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
AceHack added a commit that referenced this pull request Apr 24, 2026
- Thread P0 line 561 (markdownlint continuation-starting-with-+):
  reworded both occurrences (lines 561 and 684) so wrapped
  continuation lines no longer begin with `+` — replaced with
  `plus` / `and` / comma-series per Copilot reviewer's suggestion.

- Thread P2 line 678 (unaudited docs in pattern-summary): added
  explanatory note under the summary table clarifying that three
  audits (ALIGNMENT / TECH-RADAR / FACTORY-HYGIENE) land in
  sibling PRs #185/#188 rather than this file, and flagged that
  the rollup assumes those PRs merge. Deeper mechanical-verification
  restructure backlogged as P2 "Separation-audit cross-PR rollup".

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
AceHack added a commit that referenced this pull request Apr 24, 2026
Pattern-summary classification: ALIGNMENT moved from
factory-generic to both (coupled) to match its in-file
`## Audit —` section (codex P2 line 886). Counts updated:
4 factory-generic + 7 both-coupled + 4 zeta-library-specific
= 15.

Cross-PR note (line 895+) refreshed: PR #188 has merged, so
all 15 audits now have dedicated `## Audit —` sections in
this file; the wait-for-merge option has resolved itself. A
reader can `grep '^## Audit —'` and reproduce the 15-count
directly (copilot P1 line 72 inconsistency cleared).

BACKLOG row at line 5379 updated: removed stale "live in
sibling PRs #185 / #188 (still open)" premise (copilot P1 +
codex P2). Row now scopes to the residual concern (option c
tooling / CI diff check) since options (a) and (b) have
resolved naturally for the first 15 audits.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
AceHack added a commit that referenced this pull request Apr 24, 2026
…of ~16 done) (#190)

* frontier-readiness: gap #5 audit — 5-file planning-docs batch (15 of ~16 done)

Batched audit of the project-planning files. All classified
short-form since shape is factory-generic + content is
project-specific.

- GLOSSARY.md → both (coupled): format generic, Zeta-term
  entries specific
- ROUND-HISTORY.md → zeta-library-specific: Zeta's rounds
- BACKLOG.md → zeta-library-specific: ~6700 lines Zeta rows
- ROADMAP.md → zeta-library-specific: Zeta roadmap
- VISION.md → zeta-library-specific: Zeta vision, 11-pass
  editing history, Elisabeth dedication

Pattern after 15 audits (3 classes cleanly separated):
- 5 factory-generic (GOVERNANCE / AGENT-BEST-PRACTICES /
  ALIGNMENT / AUTONOMOUS-LOOP / FACTORY-HYGIENE)
- 6 both-coupled (CLAUDE / AGENTS / CONFLICT-RESOLUTION /
  WONT-DO / TECH-RADAR / GLOSSARY)
- 4 zeta-library-specific (ROUND-HISTORY / BACKLOG /
  ROADMAP / VISION)

15 of ~16 top-level files done. Remaining: directory-
level audits (.claude/skills/**, .claude/agents/**,
openspec/**, tools/**, .github/**).

Multi-repo split mechanical plan clearer:
- factory-generic → verbatim to Frontier (5 files)
- both-coupled → surgical edits per file, most to Frontier
  with Zeta content extracted (6 files)
- zeta-library-specific → stay in Zeta, Frontier gets
  empty templates (4 files)

Attribution: Otto (loop-agent PM hat).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

* review-drain: role-refs for VISION.md audit + fix pattern-summary count

Two PR #190 review threads:

- PRRT_kwDOSF9kNM59NTkB (P1, line ~492): rewrite direct
  contributor-name attribution to role references per Otto-220
  name-attribution discipline. "Aaron's 11-pass editorial
  lineage" -> "human-maintainer 11-pass editorial lineage";
  "Elisabeth dedication" -> generic "in-memoriam dedication
  header" with a pointer to the "honor those that came before"
  discipline in CLAUDE.md (which is where the specific
  named-memory carve-out lives).
- PRRT_kwDOSF9kNM59NTkg (P1, line ~504): pattern-summary table
  said Count=5 for "both (coupled)" but listed 6 files with a
  "(6 actually)" marker. Corrected count to 6, removed the
  marker, added an explicit 5+6+4=15 totals line so the table
  is mechanically consistent.

No semantic change to the audit classifications; the VISION.md
row still reads zeta-library-specific and the file still
belongs on the Zeta side of the split.

* review-drain: approximate line counts + correct ROUND-HISTORY attribution

Addresses 5 copilot-pull-request-reviewer threads on PR #190:
- GLOSSARY.md length 814 -> approximately 840 (current tree is ~840)
- ROUND-HISTORY append-only discipline no longer attributed to
  GOVERNANCE §2+§6 (§2 is "docs are current-state", §6 is round
  naming; neither establishes append-only). Re-attributed to the
  file's own preamble as the authoritative source.
- ROUND-HISTORY.md length 3559 -> approximately 3560
- BACKLOG.md length 6761 -> "approximately 8500 (grows tick-by-tick;
  see BACKLOG split design doc)" — switching to approximate framing
  prevents recurring drift as backlog grows, and points at the
  Phase-1a generator already on main (PR #354).
- ROADMAP.md length 177 -> approximately 178
- VISION.md length 886 -> approximately 887

Switching from exact to approximate line counts is reviewer's own
suggested remediation; this eliminates the audit's dependency on
stable file sizes that are expected to drift.

Rebased on main after BACKLOG split Phase-1a (PR #354) landed;
keep-both-sides resolution on the append-only "Files audited"
list per Otto-229.

* fix: markdownlint auto-fixes on planning-files-batch audit

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

* drain: resolve 2 threads on #190 (fix + backlog per Otto-236)

- Thread P0 line 561 (markdownlint continuation-starting-with-+):
  reworded both occurrences (lines 561 and 684) so wrapped
  continuation lines no longer begin with `+` — replaced with
  `plus` / `and` / comma-series per Copilot reviewer's suggestion.

- Thread P2 line 678 (unaudited docs in pattern-summary): added
  explanatory note under the summary table clarifying that three
  audits (ALIGNMENT / TECH-RADAR / FACTORY-HYGIENE) land in
  sibling PRs #185/#188 rather than this file, and flagged that
  the rollup assumes those PRs merge. Deeper mechanical-verification
  restructure backlogged as P2 "Separation-audit cross-PR rollup".

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

* drain: resolve 2 post-rebase threads on #190

Fixes (narrow) for both Copilot P1 at line 68 (dedicated bullets
for cross-PR audits) and Codex P2 at line 770 (honest 13-of-15
in-file count + mechanical-verification deficit flag pointing at
existing BACKLOG row).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

* rebase-cleanup: remove stale 'audit pending sibling PR' notes after #188 merge

After rebasing onto origin/main (which carries PR #188's TECH-RADAR +
FACTORY-HYGIENE audits in this file), two PR-side breadcrumb rows that
said 'audited on sibling PR #188 ... no Audit section pending that merge'
are factually wrong — the merge has happened; the Audit sections exist.

Fold the cross-PR note accordingly.

Otto-254 roll-forward; no content re-litigated.

* fix: markdownlint MD018 on wrapped #188 (backtick-wrap per Otto-260)

Post-rebase #188-reference sat at wrapped-line-start. Backtick-wrap per Otto-260 (preserve canonical form; reflow/wrap, never rename).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

* drain: resolve 4 threads on #190

Pattern-summary classification: ALIGNMENT moved from
factory-generic to both (coupled) to match its in-file
`## Audit —` section (codex P2 line 886). Counts updated:
4 factory-generic + 7 both-coupled + 4 zeta-library-specific
= 15.

Cross-PR note (line 895+) refreshed: PR #188 has merged, so
all 15 audits now have dedicated `## Audit —` sections in
this file; the wait-for-merge option has resolved itself. A
reader can `grep '^## Audit —'` and reproduce the 15-count
directly (copilot P1 line 72 inconsistency cleared).

BACKLOG row at line 5379 updated: removed stale "live in
sibling PRs #185 / #188 (still open)" premise (copilot P1 +
codex P2). Row now scopes to the residual concern (option c
tooling / CI diff check) since options (a) and (b) have
resolved naturally for the first 15 audits.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants